home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / desktop / kaos21eg.lzh / KAOSDESK.TXT < prev    next >
Text File  |  1991-09-05  |  43KB  |  884 lines
  1.  
  2.                                                          Hannover, 27.12.89
  3.  
  4.                        Instructions for KAOSDESK V2.00
  5.                       =================================
  6.  
  7.  
  8.   The important Attributes of KAOSDESK are  quite usable without reading the
  9.   handbook since, so far as possible,  all the normal Programming and Design
  10.   Conventions & Standards have been  adhered  to.   As regards Standards, on
  11.   the one hand you have programs such  as the Atari-Desktop and Neodesk, and
  12.   on the other hand general  GEM-based  programs.  KAOSDESK is an attempt to
  13.   get the best of both worlds.  KAOSDESK takes advantage of useful functions
  14.   and operations  found  on  a  variety  of  computers,  in  particular  the
  15.   Macintosh Finder, the Amiga Workbench and the GEM Desktop 2.0.
  16.  
  17.   Because it's screen operations are run  through  the VDI and AES, KAOSDESK
  18.   is compatible with any Screen Format.   It  could  be used without a great
  19.   amount of changes on a PC. Unfortunately  I don't have one, otherwise this
  20.   would already have been done !
  21.  
  22.  
  23.   0)   General:
  24.   -------------
  25.  
  26.   KAOSDESK  is an alternative Desktop for  use  under GEM 2.2, Atari GEM and
  27.   also under  KAOS  1.4.1.   At  the  start  of  the  Program,  KAOSDESK can
  28.   alternatively be  resident  (quicker)  or  will  completely  terminate  on
  29.   returning to the DeskTop (more  free  Memory!).   In each case all Windows
  30.   are self-contained and the Desktop Background consistent.
  31.  
  32.   The exit from non-resident KAOSDESK  is  made through the Operating System
  33.   function shel_write(), just  as  does  the  normal  DESKTOP.  This greatly
  34.   eliminates any possible compatibility  problems,  programs  are started in
  35.   exactly the same manner as under the original Desktop.
  36.  
  37.   Under GEM 2.x no problems  whatever  are encountered using the alternative
  38.   Desktop, when the needed Function  is  a  component  of AES.  This is also
  39.   valid for KAOS 1.4.1,  where  the  possiblity  for alternative Desktops is
  40.   even better.
  41.  
  42.   In both cases before the resident  programm SHELBUF can start something in
  43.   an Auto-Folder,  a temporary  INF-  File   must  be saved.  SHELBUF simply
  44.   puts a 5kB Buffer to the disposal of KAOSDESK for this purpose.
  45.  
  46.   The resident  Program SHELMAN  ("Shell-Manager")  is  an important part of
  47.   Atari-GEM.  KAOSDESK is able  to  do  without  this  Program.  In order to
  48.   avoid errors,  each  time  the  INF  File  is  loaded  the  switch "Reload
  49.   KAOSDESK" is set  to  "No".   SHELMAN  saves  the  last  Return-value of a
  50.   program,  so that KAOSDESK  in  "non-resident  start" also reports Return-
  51.   Codes.
  52.  
  53.   SHELMAN works under several Versions of  TOS:  1.0, 1.2 and 1.4.  For  new
  54.   (or old) versions of the Operating  Systems problems could be encountered.
  55.   In using the Cache-program  "ILLEGAL",  it's  important  to  note that the
  56.   Shellmanager may possiblly  only  start  the  last  program  in  the AUTO-
  57.   Folder.  The sequence  of  the  programs  in  the  AUTO  Folder  should be
  58.   something like the following:
  59.  
  60.                   EXAMPLE SEQUENCE OF THE AUTO FOLDER FILES:
  61.  
  62.            MFXTRB14       (Driver for c't MFII Keyboard)
  63.            DAT            (Program for setting Date & Time)
  64.            BOOT           (Program for selecting ACCs to Boot etc)
  65.            INSTAL         (for SIGNUM2)
  66.            TEMPLMON
  67.            GEMSTART
  68.            ILLEGAL        (Cache program)
  69.            SHELMAN
  70.  
  71.   In GEM 2.2 or KAOS 1.4.1, SHELMAN  can  be placed anywhere you like in the
  72.   Auto Folder.
  73.  
  74.   KAOSDESK has only been  tested  under  KAOS  1.2,  TOS  1.4  and KAOS 1.4.
  75.   However, no problems should arise using other Operating Systems.
  76.  
  77.   Under Atari GEM the time will  be  displayed  on  the extreme right of the
  78.   Menu bar, in Hours and Minutes. The  time will be updated every 10 seconds
  79.   providing no Dialog or Menu work is  in progress. This is because the time
  80.   is run under a single evnt_timer.  This  does  not have to be switched off
  81.   when  starting  a   program   since   it   will  disappear  automatically.
  82.   Nevertheless you can switch it off  using  the "Change Settings" option if
  83.   required.
  84.  
  85.   All Scrolling is done via the  AES (obj_draw), the hierarchy highest level
  86.   of the Operating System.  The Effect  is  that the output via the improved
  87.   Screen  Driver  is  essentially  much  faster  than  most  other  programs
  88.   (including the Atari Desktop). Neodesk  writes  text with Line-A routines,
  89.   and programs such as Turbo-ST are  generally  no faster and in fact output
  90.   text more slowly than KAOSDESK.  The  use  of  Line-A is, therefore, to be
  91.   avoided if possible.
  92.  
  93.   Scrolling follows the Blit- Operationof the VDI (vro_cpyfm), naturally not
  94.   using Line-A. It  is  usually  possible  to  choose  the highest Operating
  95.   System level, in order to profit  by  any Updates to the Operating System.
  96.   Similarly with other System add-ons  (Large-screen  with proper VDI Driver
  97.   or GEM 2.2 etc).
  98.  
  99.   In all operations where the window contents are changed, a new window will
  100.   be redrawn only if necessary:
  101.  
  102.   - In uncompleted Copy and Delete functions the Drive Window is not
  103.     redrawn.
  104.  
  105.   - Generally, in Copy functions only the Window carrying the Destination-
  106.     Table is redrawn (Atari-Desktop 1.4).
  107.  
  108.   - Should actual copies or deletes be requested and the Medium is Write-
  109.     Protected, the action will not be completed and the Window will not be
  110.     redrawn.
  111.  
  112.   - If "Show as Text" or "Show as Icons" is selected, then the Window will
  113.     be redrawn only if the Show Mode has changed.
  114.  
  115.   - If "Single-column" Text Mode is selected or de-selected, so only those
  116.     Windows which are not already single column will be redrawn.
  117.  
  118.   - If a Window is made smaller then that Window will be redrawn if the
  119.     reduction forces resorting, E.g. the Number of displayed columns is
  120.     smaller.
  121.  
  122.   - If a lower Window is enlarged, KAOSDESK sends a redraw instruction only
  123.     if the Window Object must be relocated. E.g. space for new columns is
  124.     required.  KAOSDESK  cannot therefore suffer from the GEM Error causing
  125.     all windows to be redrawn under these circumstances.
  126.  
  127.   - If the Text size is changed the Window will be redrawn only if "Show as
  128.     text" is in operation.
  129.  
  130.    In all DOS Functions  Error  Codes  are  requested  and analysed.  So, on
  131.   receiving a "Data on Disk A defective..." message, you never have to click
  132.   on "Abort" more than once.  In all DOS and  BIOS Calls, if an Error occurs
  133.   and the corresponding action is  uncompleted,  the appropriate Error  code
  134.   and explanitory text is displayed.  For  all  Errors there is a particular
  135.   Error message.   E.g. in Copy  or  Delete  operations,  the File and Drive
  136.   where the Error happened will be shown.  Also "Disk Full"  will be handled
  137.   by KAOSDESK internally and the corresponding message displayed.
  138.  
  139.   KAOSDESK was written specifically for the Monochrome Monitor. However,  it
  140.   contains no specific Constants for  Text  height, Screen Coordinates etc.,
  141.   and  should  therefore  cause  no   problems   if  used  in  other  screen
  142.   resolutions.  KAOSDESK runs  without  problems  on  the Atari large-screen
  143.   Monitor and will even work  on  a  large-screen  Simulator which creates a
  144.   virtual monitor in memory  and  allows  you  to  scroll the visible screen
  145.   around the virtual "large screen". Problem  are only really encountered in
  146.   Low Resolution, there the Monitor is  simply too small. This situation can
  147.   be improved (but not cured) by using a special Resource File for Low Res.
  148.  
  149.   The KAOSDESK.INF File is  Resolution-dependant.  Therefore all Coordinates
  150.   are not absolute, instead being relative to the utilizable  screen area it
  151.   was Saved from.  The up to date  Width  and Height of the screen-area will
  152.   also have been Saved at  this  time.   If  a  previously-saved INF File is
  153.   loaded, Height or Width needs  to  make  sense  in context.  The Object is
  154.   therefore that  each  Resolution  is  properly  portrayed  and  the screen
  155.   completely filled.  These comments are